home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 36 / dvpif10.zip / PIF220.DOC next >
Text File  |  1988-11-11  |  4KB  |  114 lines
  1. Appendix A:  Program Information Files
  2.  
  3. Program Information Files (PIF) are used by DESQview when loading a
  4. program to determine such things as how much memory the program needs,
  5. what the default directory should be, and how well-behaved the program
  6. is.  They are usually created and modified by using the Add a Program
  7. and Change a Program options from the Open Window menu.  The resulting
  8. file is given a name of the form xx-PIF.DVP where "xx" is the 2-key
  9. combination used to invoke the program from the Open Window menu.
  10. This Appendix describes the format of these Program Information Files.
  11.  
  12.  
  13. The first 369 bytes of the PIF are the same as for Topview.  They are:
  14.  
  15. offset    length    use
  16.  
  17.   0     2    reserved
  18.   2    30    program title (blank filled)
  19.  32     2    maximum memory required in K-bytes
  20.  34     2    minimum memory required in K-bytes
  21.  36    64    command to start program - zero terminated
  22. 100     1    default drive in ASCII (A,B,etc.)
  23. 101    64    default directory name - zero terminated
  24. 165    64    program parameters - zero terminated
  25. 229     1    initial screen mode (0-7)
  26. 230     1     # of text pages used by the application
  27. 231     1    # of first interrupt vector to be saved
  28. 232     1    # of last interrupt vector to be saved
  29. 233     1    # rows in logical window buffer
  30. 234     1    # columns in logical window buffer
  31. 235     1    row # for initial window position
  32. 236     1    column # for initial window position
  33. 237     2    system memory size in K-bytes
  34. 239    64    shared program file name - zero terminated
  35. 303    64    shared program data - zero terminated
  36. 367     1    control byte 1 - encoded as follows:
  37.             80H - Writes text directly to screen
  38.             40H - Foreground only
  39.             20H - Uses math coprocessor
  40.             10H - Accesses system keyboard buffer
  41.             01H - Swappable
  42. 368     1    control byte 2 - encoded as follows:
  43.             40H - Uses command line parameters
  44.             20H - Swaps interrupt vectors
  45.  
  46.  
  47. The next 13 bytes are optional.  They represent extensions available
  48. in all versions of DESQview.
  49.  
  50. offset    length    use
  51.  
  52. 369     2    keys-to-use on Open Window menu ("DS" for DOS
  53.         Services for example)
  54. 371     2    size of script buffer in bytes
  55. 373     2    automatically PAUSE after this many tests for keyboard
  56.         input in one clock tick (normally 0)
  57. 375     1    non-zero to disable automatic color mapping
  58. 376     1    non-zero if application is swappable
  59. 377     3    reserved - should be 0
  60. 380     1    non-zero to automatically close application on exit
  61. 381     1    non-zero if copy-protect disk is required
  62.  
  63.  
  64. The next 34 bytes are optional.  They represent extensions available
  65. in DESQview version 2.00 and later.
  66.  
  67. offset    length    use
  68.  
  69. 382     1      reserved - .DVP format number encoded as follows:
  70.             00H = DESQview version 1.20 and later
  71.             01H = DESQview version 2.00 and later
  72.             02H = DESQview version 2.20 and later
  73. 383     1    reserved - should be 0
  74. 384     1    initial # rows in physical window
  75. 385     1    initial # columns in physical window
  76. 386     2    maximum expanded memory available to program
  77.         in K-bytes
  78. 388     1    control byte 3 - encoded as follows:
  79.             80H = automatically assign position
  80.              20H = maximum memory value has been specified
  81.              10H = disallow Close command
  82.               08H = foreground-only when doing graphics
  83.             04H = don't virtualize
  84. 389     1    keyboard conflict level (0-4, normally 0)
  85. 390     1    # graphics pages used by program
  86. 391     2    extra system memory size
  87. 393     1    initial screen mode for program (normally 0FFH)
  88.  
  89.  
  90. The next 3 bytes are optional.  They represent extensions available
  91. in DESQview version 2.20 and later.
  92.  
  93. offset    length    use
  94.  
  95. 394     1    serial ports usage (normally 0FFH)
  96.             -1 = use all serial ports
  97.              0 = not using serial ports
  98.              1 = use COM1 only
  99.              2 = use COM2 only
  100. 395     1    control byte 4 - encoded as follows (normally C3H)
  101.             80H = automatically close application on exit
  102.                               if .COM or .EXE extension specified
  103.             40H = swappable if not using serial ports
  104.             08H = virtualize text - overrides previous value
  105.             04H = virtualize graphics - overrides previous value
  106.             02H = share CPU when foreground
  107.             01H = share EGA when foreground and zoomed
  108. 396     1      degree of protection
  109. 397    19    reserved
  110.  
  111.  
  112. Note:  For all control bytes, undefined bits should be set to zero for future
  113. compatibility.
  114.